package cn.iocoder.yudao.module.ao.service.vocationalclassschedule;

import java.util.*;
import javax.validation.*;
import cn.iocoder.yudao.module.ao.controller.admin.vocationalclassschedule.vo.*;
import cn.iocoder.yudao.module.ao.dal.dataobject.vocationalclassschedule.VocationalClassScheduleDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

/**
 * 中高技班级课 Service 接口
 *
 * @author 智教云枢
 */
public interface VocationalClassScheduleService {

    /**
     * 创建中高技班级课
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createVocationalClassSchedule(@Valid VocationalClassScheduleSaveReqVO createReqVO);

    /**
     * 更新中高技班级课
     *
     * @param updateReqVO 更新信息
     */
    void updateVocationalClassSchedule(@Valid VocationalClassScheduleSaveReqVO updateReqVO);

    /**
     * 删除中高技班级课
     *
     * @param id 编号
     */
    void deleteVocationalClassSchedule(Long id);

    /**
    * 批量删除中高技班级课
    *
    * @param ids 编号
    */
    void deleteVocationalClassScheduleListByIds(List<Long> ids);

    /**
     * 获得中高技班级课
     *
     * @param id 编号
     * @return 中高技班级课
     */
    VocationalClassScheduleDO getVocationalClassSchedule(Long id);

    /**
     * 获得中高技班级课分页
     *
     * @param pageReqVO 分页查询
     * @return 中高技班级课分页
     */
    PageResult<VocationalClassScheduleDO> getVocationalClassSchedulePage(VocationalClassSchedulePageReqVO pageReqVO);

    /**
     * 导入中高技班级课
     *
     * @param importVocationalClassSchedules 导入的中高技班级课列表
     * @param updateSupport 是否支持更新
     * @return 导入结果
     */
    VocationalClassScheduleImportRespVO importVocationalClassScheduleList(List<VocationalClassScheduleImportExcelVO> importVocationalClassSchedules, Boolean updateSupport);

    /**
     * 清理无效的教师数据
     */
    void cleanInvalidTeacherData();

    /**
     * 清理教师信息中的无效科目（如"班主任"等职务）
     */
    void cleanInvalidTeacherSubjects();

    /**
     * 清理无效的课程数据
     */
    void cleanInvalidCourseData();

    /**
     * 强制提取所有可能的教师姓名
     */
    void forceExtractAllPossibleTeachers();

    /**
     * 测试课程创建功能（用于调试）
     */
    void testCourseCreation();

    /**
     * 清理重复的场地数据
     */
    void cleanDuplicateLocationData();

    /**
     * 测试基于位置的教师提取逻辑
     */
    void testPositionBasedTeacherExtraction();

    /**
     * 扫描现有课程表数据，发现并补充遗漏的科目和教师
     */
    void scanAndSupplementMissingData();

    /**
     * 基于位置的智能课程信息提取
     */
    void extractCoursesByPosition();

    /**
     * 测试新的格式识别逻辑
     */
    void testNewFormatRecognition();

    /**
     * 测试一段式课程验证逻辑
     */
    void testSingleSegmentCourseValidation();

    /**
     * 检查是否有周六或周日的课程数据
     */
    boolean hasWeekendCourseData();

}